Shareware Super Platinum 8/Shareware Super Platinum 8.iso/mac/EDITORS/WF310C.ZIP;1/WF310DOC.ZIP/DOCS/WF.006

Text File | 1992-01-31 | 22.1 KB | 576 lines

.f3                              - # -          Chapter 6 - Working With Blocks
.rm70
.tc
.tc1
.tc 6. WORKING WITH BLOCKS ................................#
CHAPTER 6   WORKING WITH BLOCKS

.ixMoving;Moving blocks of Text - see Blocks
.imBlocks
A block of text is an area that starts with a Begin Block marker, and
terminates with an End Block marker. Normally, all text from the
Beginning going left to right and down the file is included up to the
end block marker. However, if Column Mode is set, then the block
markers also set column boundaries, and only text within those columns
is included.

.tc    Mark a Block of Text ...............................#
Mark a Block of Text

.ix   Mark block  (^KB & ^KK)
1. Place the cursor at the beginning of the block.
2. Press the block begin keys: Ctrl K B or F7.
3. Move the cursor to the end of the block. Press the Block end
   sequence: Ctrl K K or F8. The block will be highlighted in
   complementary colours.

Font Display

If Font display is OFF, then the cursor column position is where the
block marker is set. If Font Display is ON, then if the cursor is
positioned just after a font marker, the beginning block will be moved
left until the character prior to the block marker is not a font
character. Conversely, if the End block marker is positioned before a
font display character, the End block marker will be moved right until
it is positioned over a non font character. This is to ensure that
font characters are included in blocks when they are marked if font
display is ON.

Columns Included

The column the cursor resides in is included in the beginning of
block, but is excluded from the end of block. If column mode is OFF,
then all text between the Beginning and the End markers is included.
When column mode is ON (the status line will show Tbl I or Tbl R) the
text must be within the columns delimited by the beginning and end
markers.

.Tc    Hide a Block .......................................#
Hide a Block

.ix   Turn of Marking (^KH)
Once a block is marked, it can be hidden from view. When it is hidden,
it is treated as if it had never been marked, except that if you enter
the Hide block command a second time without changing the block
markers, then the hidden block will be revealed again.

To hide a block press Ctrl K H

.tc    Columns ............................................#
Columns

.ix   Column Blocks
When column mode is active, blocks of text are delineated by columns.
There are 2 types of column mode: Column Mode and Column Replace Mode,
and they affect the way in which blocks of text are moved and copied.

Column Mode

.ixColumns;   Column Blocks
To toggle column mode, enter Ctrl K N. If column mode is OFF, it will
be turned ON, and vice versa. Column mode determines that blocks mark
columns of text, and with word wrap, that words wrap within columns.
The status line will display either Tbl I or Tbl R, depending upon
whether Column Replace is also on.

Column Replace Mode

.ixColumns;   Column Replace (^KI)
.ixColumns;   Column Mode    (^KN)
To toggle column replace mode, enter Ctrl K I. If column replace is
OFF, it will be turned ON, and vice versa. However, it will have no
effect unless column mode is also on.

When column mode is ON and column replace is OFF, columns of text
displace any text on lines they are moved (or copied) into, and lines
they are moved (or deleted) from have their text moved left to fill in
the gap.

When column mode is ON and column replace is ON, columns of text
overwrite text on lines into which they are moved (or copied), and
lines they are moved (or deleted) from have the text replaced by
spaces.

This is covered in more detail in Move, Copy and Delete below.

.Tc    Moving a Block .....................................#
Moving a Block

.ix   Moving (^KV)
To move a block of text within a file:
1. Mark the block of text with Ctrl K B and Ctrl K K.
2. Move the cursor to the new location for the block.
3. Press Ctrl K V and the text is moved.
4. Press Ctrl K H to unmark the block.

If Column mode is OFF, then the moved text will be inserted where the
cursor is, regardless of the setting of INS. The text to the right of
the cursor will be pushed right, and if the block consists of more
than one line, additional lines will be inserted. To move a complete
line, go to column one and mark the beginning, and then go down one
line and mark the end in column one as well. The text is deleted from
its original position in a move. If the moved text is all in one line,
then no gap will remain after the text is moved.

In the examples below, the marked text is underlined. The cursor is
shown by a single underline character _

No Columns{.Œ}
(i)     Partial line.

         Friends, Romans and countrymen, lend me your ears.
         Now is the time

        becomes

         Friends, Re your ears.
         Now iomans and countrymen, lend ms the time

.cp7
(ii)    Multiple lines

         'Twas brillig and the slythy toves
         did gyre and gymbol in the gabe.
         All mimsey were the borogoves,
_        and mome raths outgabe.

        becomes

         All mimsey were the borogoves,
         'Twas brillig and the slythy toves
         did gyre and gymbol in the gabe.
_        and mome raths outgabe.

Column Mode

.ix   Moving Columns
If Column Mode is ON, and Column Replace mode is OFF, (the status line
shows Tbl I) then the moved text pushes text on the line to the right
for each line that has text moved to it. The source text is deleted,
and the text on the line flows left to fill in any gaps:

Example

          This is the date that the decision was made not to pursue
          the assessment, or the date on which the decision was made
          not to offer a program, or the date on which the Assessment
          deliverables (eg rehabilitation plan or assessment report)
          were produced. If not filled in, when the client proceeds to
          the Program Details screen, it will default to the start
          date from the first current objective.

        becomes

          Thie that the decision was s is the datmade not to pursue
          the or the date on which th assessment,e decision was made
          notprogram, or the date on  to offer a which the Assessment
          delg rehabilitation plan oriverables (e assessment report)
          werIf not filled in, when te produced. he client proceeds to
          the Program Details screen, it will default to the start
          date from the first current objective.

which does not make a lot of sense for text, but serves to illustrate
what happens.

.cp15
Column Replace

.ix   Moving Columns
If Column Mode is ON, and Column Replace mode is ON, (the status line
shows Tbl R) then the moved text overwrites text on the line to the right
for each line that has text moved to it. The source text is deleted,
and the text on the line replaced by spaces.

.cp10
Example

          This is the date that the decision was made not to pursue
          the assessment, or the date on which the decision was made
          not to offer a program, or the date on which the Assessment
          deliverables (eg rehabilitation plan or assessment report)
          were produced. If not filled in, when the client proceeds to
          the Program Details screen, it will default to the start
          date from the first current objective.

        becomes

          Thie that the decision was             made not to pursue
          the or the date on which th            e decision was made
          notprogram, or the date on             which the Assessment
          delg rehabilitation plan or             assessment report)
          werIf not filled in, when t            he client proceeds to
          the Program Details screen, it will default to the start
          date from the first current objective.


As you can see, column moves will correctly handle overlapping blocks,
provided the cursor is not positioned within the block. If this is the
case, the move rejects. For a column move, the first column of the
block is a valid cursor position, and can be used to move a block up
or down a few lines. Shifting blocks of text left or right in the line
can also be accomplished by the Shift Left and Shift Right commands.
(See below)

NOTE  Column mode is checked on the source window, so if you are
      copying or moving from one window to another, the settings on
      the source window will be assumed to hold for the destination.
      If this were not the case, strange things could happen if a
      column of text were moved (or copied) and then treated like a
      series of lines at the destination.

.IRExamples;Examples & TIPS see TIPS
.ixTIPS;   Different column settings & blocks
TIP   If you need different column mode setting on 2 windows (ie
      column mode on one and column replace on the other) for a move,
      set the appropriate settings for the destination on the source
      window, and Copy the block. The change the settings on the
      source window, Redefine the block, and Delete it.

.Tc    Copying a Block ....................................#
Copying a Block

.ix   Copying
To copy a block of text within a file:
1. Mark the block of text with Ctrl K B and Ctrl K K.
2. Move the cursor to the new location for the block.
3. Press Ctrl K C at the location to copy the text.

Copying functions almost identically to moving a block, except that
the source text is unchanged.

.cp5
.Tc    Deleting a Block ...................................#
Deleting a Block

.ix   Deleting
.ixDeleting            ;   Block of Text
To delete a block of text:
1. Mark the block of text with Ctrl K B and Ctrl K K  .
2. Press Ctrl K Y and the text is deleted.

Deleting functions in a similar fashion to moving text, where the
source text is deleted. There is naturally no destination. Deleted
blocks are copied to the Undo buffer, but only as many lines as will
fit. The undo buffer acts as a stack, in that the last line pushed
onto it is the first one out, except that if the buffer is full, the
oldest text is dropped off the bottom, and the space returned

.cp5
.Tc    Undeleting a Block .................................#
Undeleting a Block
.ixUndo;   Undeleting a block (^QV)
.ix   Undeleting a block (^QV)

To undelete the text currently in the Undo Area:
1. Place the cursor where you want to insert the text from the Undo
   Area.
2. Press Alt Y once for each line.
OR
2. Press Ctrl Q V to insert the entire undo buffer.

The amount of text in the undo buffer is limited to the number of
lines you select in the Undo limit menu item on the Global file
options sub menu on the Options menu. It defaults to 200.

.tc    Writing to a File ..................................#
Writing to a File
.ixWriting;Writing to a File
.ix   Writing to a separate file (^KW)

To copy a block of text to another file:
1. Mark the block of text with Ctrl K B and Ctrl K K.
2. Press Ctrl K W. A window will prompt:

    …ÕÕÕÕÕÕÕÕÕÕ Filename to Write to ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕª
    ∫                                                    ∫
    »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕº

3. Type a file name and press Enter.

If the block is defined as a column, only a column will be written.

.tc    Inserting a File ...................................#
Inserting a File

.ix   Inserting a file (^KR)
.ix   Read a block (^KR)
.ixInserting;Inserting a file
To insert a file into the file you are editing:
1. Press Ctrl K R where you want the file inserted. A window will
   prompt

    …ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ Read File ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕª
    ∫                                                    ∫
    »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕº

2. Type a file name and press Enter. The file will be inserted after
   the cursor.

The file is treated as not column mode, and the setting of the
destination window are ignored.

.CP6
.ixTIPS;   Inserting in column mode
TIP   If you want to read in a file as a column, open a separate
      window for the file, and read it there. Then set the column
      settings you want, mark the block of text in the file, and Copy
      or Move it to the Destination window.

.cp5
.tc    Shift Left .........................................#
Shift Left

.ix   Shift block left
A marked block can be shifted left or right on the line(s). Column
mode blocks can also be shifted.

To shift a marked block left press Ctrl K < or Ctrl F7. You will be
prompted for the number of columns to move the block.

    …ÕÕÕ Cols to Shift Left ÕÕÕÕÕÕÕÕª
    ∫ 2                             ∫
    »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕº

Blocks that are not column mode blocks can be shifted left beyond the
left margin. Any characters shifted beyond the left margin will be
lost.

Column mode blocks always behave as if Column Replace is ON. That is
that text overwrites any text to the left, and columns left blank are
blanked. It is not possible to shift a column mode block beyond the
left margin.

.cp5
.tc    Shift Right ........................................#
Shift Right

.ix   Shift block right
To shift a marked block right press Ctrl K > or Ctrl F8. You will be
prompted for the number of columns to move the block.

    …ÕÕÕ Cols to Shift Right ÕÕÕÕÕÕÕª
    ∫ 2                             ∫
    »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕº

As the block is shifted to the right, the columns vacated are filled
with spaces. It is not possible to shift a block further right than
the maximum line length, which is 999 characters.

Column mode blocks always behave as if Column Replace is ON. That is
that text overwrites any text to the right, and columns left blank are
blanked.

.tc    Strip Hi Bits ......................................#
Strip Hi Bits

.ix   Strip High bits
Some word processors such as WordstarTM can set the hi bits of certain
characters on, resulting in the text looking like Greek or something.
You can turn off hi bits when you load a file (refer to Load File
Options) or you can mark a block and turn off the hi bits in the
block.

To strip off hi bits in a marked block, press Ctrl K ^ (shift plus the
6 key)

.CP5
For example:
    †°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈Δ«»… ÀÃÕŒœ–—“‘’÷◊ÿŸ⁄€ÊÁËÈ

  becomes
     !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRTUVWXYZ[fghi


.tc    Toggle Case ........................................#
Toggle Case

.ixCase Convert;Case Conversion (^K' ^K" AltF10 Alt9)
Toggling the case of a marked block means turning capital letters into
lower case letters and vice versa. If the block is marked and visible,
and the cursor is positioned in the block, the command affects the
entire block. Otherwise the command operates only on the character
under the cursor. European characters from the standard Ascii set are
also handled correctly.

To change the case of a block, press Alt F10.

There is also a shortcut (macro) set up to allow you to change the
case of consecutive letters. You press Alt 9 (using the numbers along
the top of the keyboard), and if you hold these 2 keys down, the
cursor will move to the right  along the line you are editing, and the
case of each letter through which it passes will be changed, either
from Upper to Lower, or from Lower to Upper.


.tc    To Upper Case ......................................#
To Upper Case

.ix   Uppercase (^K")
.ixCase Convert;Case Conversion (^K' ^K" AltF10 Alt9)
This command turns characters into upper case. If the block is marked
and visible, and the cursor is positioned in the block, the command
affects the entire block. Otherwise the command operates only on the
character under the cursor. European characters from the standard
Ascii set are also handled correctly.

To convert to Upper case, press Ctrl K ".  (you need the shift key for ")


.tc    To Lower Case ......................................#
To Lower Case

.ix   Lowercase (^K')
.ixCase Convert;Case Conversion (^K' ^K" AltF10 Alt9)
This command turns characters into Lower case. If the block is marked
and visible, and the cursor is positioned in the block, the command
affects the entire block. Otherwise the command operates only on the
character under the cursor. European characters from the standard
Ascii set are also handled correctly.

To convert to Upper case, press Ctrl K '. (no shift key for ')

.tc    Format Block .......................................#
Format Block

.ix   Format block (^KF)
This command applies the format paragraph command to the marked block.
You will need word wrap to be active for this to work. You can use
this to reformat a number of paragraphs at one time, even the entire
document. (You should ensure that they all use the same formatting, or
that you have embedded ruler lines for each formatting change).

Press Ctrl K F.

.CP5
In non column mode, each paragraph that is part of the marked block is
reformatted.

.CP5
In column mode, the start and end block markers define the line
boundaries of the paragraph reformatting. The columns are determined
from the columns set in the ruler line, and depend on where the cursor
is. Reformatting columns of text without reference to existing column
margins does not make a lot of sense.


.tc    Sort a Block .......................................#
Sort a Block

.ix   Sort a Block
This command allows you to sort a marked block in either ascending
order (A..Z) or descending order (Z..A). You will be prompted whether
you want the block sorted in ascending or descending order. The marked
block will then be sorted in the sequence you selected.{.Œ}
{.Œ}
Sorting is not case sensitive. This means that Upper case and Lower
case characters will sort together, so that "APPLE" and "apple" will
sort together. The entire line is ALWAYS sorted, even in column mode
with a limited block.

If you are in column mode, or the start column is not the same as the
end column, only the characters between the 2 column limits will be
compared, otherwise the first 50 characters of the lines will be
compared.

YOU CANNOT UNDO A BLOCK SORT - YOU MAY WANT TO SAVE YOUR FILE FIRST


.tc    Export Ascii .......................................#
Export Ascii

.ix   Convert to ASCII (^JA)
A marked block can be exported as a pure ascii file, with print
control commands stripped out, by pressing Ctrl J A. If the block is
marked and visible and in the current window, then only the contents
of the marked block is exported. Otherwise the entire file in the
current window is exported as ascii text.

You will be prompted for a file name to export to, and if the file
exists you will also be asked whether to over-write or append to the
end of the file.

Ascii text means that all embedded control characters are stripped
out, and all print commands are stripped out. Each line ends with a
hard carriage return (which is the norm for Word Fugue files anyway).
Hi order bits are not affected, so graphical characters stay the same.
If you need to remove these, use the strip hi bits command.


.CP5
.tc    Set Font for a Block ...............................#
Set Font for a Block

.ix   Set Font For
If you mark a block and then place the cursor within the block, you
can mark the block with a particular font command. The quote key Ctrl
P will not set a font for a block, but will only insert the font
marker at the cursor, so you must use the installed font commands for
this to be effective:


.CP11
               Bold            Alt B
               Double Strike   Alt D
               Underline       Alt U
               Superscript     Alt T
               Subscript       Alt V
               Compressed      Alt C
               Italics         Alt I


               Fig 6.1 - Block Font Commands
.tc1 Fig 6.1 - Block Font Commands .........................#


.CP10
The appropriate font marker will be inserted at the beginning and end
of the marked block, and the block marking will be turned off to let
you see the new font (if font display is active).

The cursor must be within the block, otherwise the command simply
inserts a font marker at the cursor position.

Column Mode Blocks

Column mode blocks can also be marked as a particular font in exactly
the same method as above. In this case however, the font markers are
inserted at the left and right boundary columns of the block on each
line within the block.

For example, in Fig 6.1 above, the bolded list of commands can be
bolded by marking the column as a column mode block, placing the
cursor anywhere within the block, and pressing Alt B. Don't forget to
turn column mode off afterwards.


.CP5
.tc    External Pick Buffers ..............................#
External Pick Buffers
.ix   External Pick Buffers
.ixPick Buffers;Pick Buffers

Although you can have only one marked block active, Word Fugue
supports the use of external pick buffers, into which a marked block
can be copied, and subsequently retrieved. You can have 10 of these
external pick buffers, numbered 0 to 9.

This acts as an extension to the paste command (Alt O):

Alt O X n    where n = 0 to 9 will export the marked text to
             the appropriate pick buffer. If you have the option
             Always use Descriptions ON, you will be prompted for a
             description for this block.

.CP5
Alt O n      where n = 0 to 9 will import text from the pick
             buffer. This text can be imported as often as you
             wish.

Alt O I n    where n = 0 to 9 will import text from the pick
             buffer. This text can be imported as often as you
             wish. In this case you will see a list of the available
             pick buffers, with descriptions if you set them up when
             you exported the text.

The text is actually stored in files called PICKBFR.0 to PICKBFR.9